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PREFACE 


Thie manual describes the functions of the Operating System/32 
(OS/32) Library Loader under the 0S/32 operating system. This 
manual is intended for operators, programmers, and system 
administrative personnel. 


Charter 1 discusses loading and starting the library loader along 
with loading pure and impure segments. Chapter 2 presents all 
library loader commands and their definitions. 


Appendix A contains the command summary, while Appendix B 
contains the message summary. A sample command sequence is shown 
in Appendix C. Appendix D presents a sample file library 
creation. 
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CHAPTER 1 
THE OPERATING SYSTEM/32 (0S/32) LIBRARY LOADER 


1.1 INTRODUCTION 


The Operating System/32 (0S/32) Library Loader resolves external 
references, edits file libraries, defines common blocks, and 
builds object load modules. The library loader operates under 
 OS/32 and interactively accepts commands and generates messages 
to the operator. Library loader biases programs on a doubleword 
boundary. 


An object program library file can be created on a bulk storage 
device by using operator commands. This file can be searched for 
a particular program, selectively copied onto another logical 
unit (lu), or added to under operator control. Automatic link 
editing is available allowing the operator, with one command, to 
load all library programs required for any one particular job. 
A group cf programs can be pseudo-loaded, producing a single 
absclute load module that can be originated at any address, and 
then loaded by the 32-Bit Relocating (REL) Loader. This module 
contains forward references but no entry point or externally 
referenced symbols. 


1-2 OS/32 LIBRARY LOADER OPERATION 

After loading the library loader, lu 5 must be asSigned by the 
user for the command file. Primary and optional secondary input 
files along with optional output files can be assigned to any of 
the other lu devices. 

After entering the START command, library loader displays’ the 
following message: 


LIBLDR~-RBnn 


This message indicates that the library loader is ready to accept 
commands. This message is also displayed after the XOUT command 
is entered. 
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1-3 PROGRAM LOADING WITH PURE AND IMPURE SEGMENTS 


Program segmentation allows certain blocks of executable code to 
be shared when operating under 0OS/32. Segmentation is 
acccmplished by dividing a file into pure and impure segments at 
assembly time. The pure segment is a sharable segment while the 
impure segment is not. There are certain rules used to handle 
file segmentation. For example, a program such as CAL, that 
contains both pure and impure segments, can be loaded and 
executed by specifying a single impure bias value. The BIAS 
command is used to specify the impure bias for this type of 
program load operation. 


As another example, a FORTRAN program can be loaded with a single 
impure bias value, even though the main program is impure and the 
run time library routines are pure. All programs, pure or 
imptre, are loaded contiguously when only the single bias value 
is specified. To serarate the pure and impure segments of a 
program or number of programs, specify a pure bias, using the 
pure bias (PB) command, and pure segments will be originated at 
the pure bias, and impure segments at the impure biase When the 
pure bias is zero or unspecified, all segments are loaded at the 
impure bias valuee The BIAS command automatically zeros the pure 
bias value; therefore, when specifying both biases, enter the PB 
command after the BIAS command. Table 1-1 displays program 
loading and the pure and imrure bias addresses. 


TABLE 1-1 PROGRAM LOADING 


{PROGRAM CONTAINS | 


| | 
| BIAS  {|PURE BIAS |------------ ----| l 
{|SPECIFIED|{SPECIFIED|PURE  |IMPURE | RESULT | 
| { {|SEGMENT|{SEGMENT | { 
| a 2 2 | 
| 0 (1) | 0 { *(2)| {Program loaded (PBOT) (3) | 
lic Niclas nie sean aceaeg 7 ale maces en gare meseee | 
| 0 | 0 | | x [Program loaded at PBOT | 
ae a eg rice ae need arena oe -| 
| 0 | 0 | * | . {Pure segment loaded at | 
| | | { {PBOT. Impure segment | 
| | | | jimmediately follows pure | 
| | | | jsegment. . | 
none nnn nnnn nnn nnn nnn nnn nnn nn nn nnn nnn mw enn nnn n nnn senna annenee | 
{ * { 0 | = | {Program loaded at impure | 
| | | | [bias address | 
eg ace ni ide eel ia a ev cess Cera RIG AEE | 
| . | 0 | | * {Program loaded at impure | 
| { | | Jbias address | 
a Fea gle Sec eg ig i gees ew ce Re | 
| ~ 0 = = {Pure segment loaded at | 
| jimpure bias address. | 
| 

| 


| 
| 
| JImpure segment immediate-| 
| {ly follows pure Segment. | 
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| {PROGRAM eONter Nes 


| ™ J|Pure segment Ilcaded at | 
| Jpure bias address. Imocure | 
| {segment loaded at impure | 
| jbias address | 


sae ee ORE ew Ow eZ Owe se w@wewerwereewes see weeseeaeewrw OO Beeeeeteaneweeweeeweweaen ae 2 ewe e es @B eaewewe = 


l | 
! PIAS [PURE BIAS [eee + -4-s-5---5 i | 
[SPECIFIED {SPECIFIED|PURE {IMPURE | RESULT | 
| | [SEGMENT{SEGMENT | | 
| Se ee ee ee ee cen a ee ae ae ne ee Se ee ee a re SS Se Ser SS OS SS SS Se SS Se ae ee SS ee OR an ee a SP oan ee ate eee ae Coo ea Soo | 
| 0 | ig | = | {Program loaded at pure | 
| | | | [bias address | 
[Beran orn see ess Seep onete as ero e see sarees sores | 
| 0 { i | | . {Program loaded at PBOT [ 
gnu pea aia enc cia ahaa aa rain coe At Gen cna ears oe | 
| ) | - | * | * jPure segment loaded at | 
| | { | Jpure bias address. Impure | 
| | | | jJsegment loaded at PBOT [ 
ates ge scistrieis es aiaiac inaccuracies eis ae se eae oeiare acca eae | 
| * | bs | * | {Program loaded at ure | 
| | | | [bias address | 
aad anol woe ia CE | 
| * | i | | * JProgram loaded at impure | 
| | | | {bias address | 
[eee ae era Agee ee ee eee ee eee | 
| tk * * 

| 

l 

| 


1 If no bias is specified, zero is the default. 


2 * indicates specified. 


Las 


PBOT indicates pure Eottom. 


1-4 STATEMENT SYNTAX CONVENTIONS 
These statement syntax conventions are used in all 
statement, command, and instruction formats: 


CONVENTION USAGE 


Capital letters, must be entered exactly as shown. 
parentheses, and 
punctuation marks 


Lowercase letters represent parameters or information 
provided by the user. 
n 
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Underlining 
PAUSE 
Ellipsis 


CFaraml,eeers,Earams 


Lettering with shading 


Braces 


i 


Brackets 


Braces inside brackets 


. 


Commas 


Comma inside brackets 


Comma preceding braces 
inside brackets 


7 


indicates only the underlined por- 
tion of the entry is required. 


represents an indefinite number of 
parameters or a range of parameters. 


represents a default option. 


represent required parameters from 
which one must be chosen. 


represent an optional parameter that 
can be chosen. 


represent Optional parameters from 
which one can be chosen. 


separate parameters and substitute 
missing fositional parameters. 


must be entered if the optional 
parameter is chosen. 


must be entered tH one of the 
optional parameters is chosen. 


W8-O20 RIO 4/80 


Comma outside brackets 


except last parameter positional parameters 


separate optional parameters 
are chosen. Commas are omitted 


HiPigie teadiing parameters. 


J 


, 


Equal sign separating must be entered to 
keyword from parameters parameter with keyword. 


KEYWORD=param 
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NOTE 


Library loader commands require that only 
the first two letters of each command be 
entered. This is true in all cases 
except one: the LINKFILE command uses 
the letters LF so it will not be confused 
with the LINK (LI) command. 


4/80 


must be entered in place of 


Missing 


to 


that 
for 


associate 


CHAPTER 2 
LIBRARY LOADER COMMANDS 


2-1 INTRODUCTION 


Library loader commands are presented alphabetically in this 
charter. All library loader commands are listed below: 


AMAP LC (LABEL COMMON) 
BF (BACKSPACE FILE) LINK 

BR (BACKSPACE RECCRD) LF (LINKFILE) 
BIAS LOAD 

BC (BLANK COMMON) LG (LOG) 

COFY MAP 

DUPE OUT 

EDIT PAUSE 

ENT FR (PURE BIAS) 
FIND RW (REWIND) 

FF (FORWARD FILE) TABLE 

FR (FORWARD RECORD) TOP 

GC WF (WRITE FILEMARK) 
LABEL XOUT 
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|  AMAP 


2-2 AMAP COMMAND 


The AMAP command outputs a memory map to the specified logical 


unit (lu) with all symbols 


Formats: 


AMAP lu 


Parameters: 


lu 


Examples: 


AM PR: 


PROGRAMS: 

NAME IHFURE 
ASYNCTOP O266E0 
CLEANUP OOEE9QE 
CMEX.FO08 0125C0 


ENTRY POINTS: 
013E88 SBUILL 
013F22 SEXIT 
014024 SIFNG 
COMMON=-BLOCKS: 


UNDEFINED: 


is a 


listed in alphabetical order. 


decimal number fron 1 through 


254 


specifying the lu on which the map is output. 


PURE ABS 
000030 


013F52 SCLEAR 
014018 SIFE 
014030 SIFNL 


NAME IMPURE PURE ABS 
CDVR-FO1 OOF558 
CMHDB.F28 OOFBOO 
CMON.FO1 014A20 


014188 SCOPY O140E4 SELSE 014114 SENDC 
014000 SIFG 01400C SIFL 01403C SIFNE 
014060 SIFNNULL 014048 SIFNULL O1409E SIFNX 
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2-3 BEF (BACKSPACE FILE) COMMAND 


The BF command backspaces the liu one filemark, leaving the lu 
positioned before the filemark. If no filemark is found, an 
errcr message is issued. 


Format: 
BF lu 
Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


Functional Details: 


If the lu is positioned at the first file and the BF command is 
issued, an error message will be displayed. The RW (rewind) 
command must be used in this case, and the lu will be positioned 
at load point. 


Exargple: 
BF 2 Backspaces one filemark on lu 2. 
Errcr Messages: 


I/O DEVICE ERROR No filemark was found. 
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| BACKSPACE | 
{ RECORD | 


2-4 BR (BACKSPACE RECORD) COMMAND 


The BR command backspaces the lu one record in the file. 
Format: 
BR lu 


Parameterss 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


Example: 


BR 2 Backspaces one record on lu 2. 
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2-5 BIAS COMMAND 


The BIAS command sets a bias address to be used as the base 
address for the next impure relocatable program. 


Formats: 
BIAS[adr] 
Parameters: 


adr is a  1- to 6-digit hexadecimal humber 
specifying the address to be used as the base 
address. If this parameter is omitted, the 
default is the next available location above 
the highest address used. 


Functional Details: 


The impure bias address becomes the bias of the impure 
relccatable segment. Immediately after loading any file, the 
bias value is set to the next available location above the 
highest address usede- When the loader is initially loaded, bias 
is set to the next lecation above the loader. This value is not 
initialized when the loader is restarted. If no operand is 
specified in this command, the bias is set to the next location 
above the loader. The BIAS command resets the pure bias value to 
ZeloOe The BIAS command cannot be used during output of an 
overlay module. 


If the BIAS command is not specified, the bias default is zero. 


Example: 


BI 189C Sets the bias at X°189C’. 
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{ BLANK | 


2-6 BC (BLANK COMMON) COMMAND 


The BC (BLANK COMMON) command allocates the maximum amount of 
memcry in bytes for blank ccmmon area. 


Format: 


BC n 


Parameters: 


n is a  1=- to 6-digit hexadecimal humber 
specifying the number of bytes to allocate for 
a blank common. 


Functional Details: 


The BC command must be entered before the LO command is entered. 
When a blank common area is specified by the BC command, the 
loader places the common area at the impure bias value or at the 
impure bias value plus labeled common, if labeled common was 
previously specified. (See LC command). BLANK COMMON cannot 
contain pre-loaded data. 


Exaugple: 


BC 2000 Allocates X°2000' bytes for blank common. 
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2-7 COPY COMMAND 


The copy command copies one program from the first lu to the 
seccnd lu. 


Format: 
COPY lu,,lu,[program-label | 
Parameters: 


Lu is a decimal number from 1. through 254 
specifying the lu to which a device is 
assigned. 


program-label is a%1- to 8-character alphanumeric string 
specifying the name of the program on the 
specified lu to be copied from one lu to 
another. 


Functional Details: 


If a program-label is specified, the first lu is Searched for the 
specified rfrogram-label. If no program-label is specified, the 
first program encountered on the first lu is copied. After a 
copy operation is completed, the first lu specified is 
left-positioned past the end cf the copied progran. 


Examples: 


CO 1,2 INITCRT Copies the file INITCRT from lu 1 to 
lu 2e 
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2-8 DUPE COMMAND 


The DUPE command copies programs from the first lu to the second 
lu until the specified program is found. The specified progran 
is not copied and the operation terminates. 


Formats: 


DUPE 1lu,,1lu,[program-label| 


Parameters: 


lu 


program-label 


Functional Details: 


is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


is a t- to 8-character alphanumeric string 
specifying the name of the program on the 
specified lu to be searched to terminate the 
dupe operatione 


If no program-label is specified, programs are copied until an 
EOF or EOM on the first lu is detected. 


Exagple: 


DU 1,2 INITCRT 


Copies all files from lu 1 to lu 2 
until the file INITCRT is found. 
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2-9 EDIT COMMAND 


The EDIT command searches the specified library tape or file and 
selectively loads those programs needed to satisfy external 
references (EXTRNs) within previously loaded programs. 


Formats: 
EDIT lu[program-label | 
Parameters: 


Lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


program-label is a 1- to 8-character alphanumeric string 
specifying the program-label on the specified 
lu to be found. 


Functional Details: 


The criterion for loading during an edit operation is a match 
between the label of a program in the library file and the 
symbolic name of any EXTRN in the loader symbol table. The EDIT 
commands: 


@e searches for the program on the lu before starting the edit 
Erocess, if a program-label is specified. If no program-label 
is specified, the lu is processed from its current position. 


e searches the loader symbol table for undefined EXTRNs. If 
there are none, the operation terminates. 


e searches for an lu forward from itsS current position for a 
grrogram-label matching an undefined EXTRN, if there are 
undefined EXTRNs in the symbol table. If such a label is 
found, that program is loaded and linked, and the second step 
is repeated. If an EOF or EOM is encountered in the search, 
an appropriate message is logged, and the operation 
terminates. 
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The EDIT command does not have the rewind capability. 

If an ENDVOL is read, the edit operation terminates. This 
label can be placed at the end of each paper tape file library 
to prevent reading off the end of the tapee Following an 


edit, the MAP command can be used to determine if any 
undefined EXTRNs are in the symbol table. 


Example: 


ED 4 Resolves external references from lu 4. 
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2-10 END COMMAND 


The END command terminates the library loader. 


Formats: 


END 
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2-11 FIND COMMAND 


THe FIND command searches the specified lu until the 
user-specified program is found. The lu is then backspaced to 
the beginning of the that program, which then can be loaded or 
linked. 


Format: 
FIND lu[program-label| 
Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


program-label isa 1- to 8-character alphanumeric string 
specifying the name of the program to be 
found. 


Functional Details: 


The lu is not rewound by the library loader when the FI command 
is given. Use the FI command to position a file containing 
several programs. If the file is not on a rewindable device, 
backspace the file one record after the FI command is completed 
befcre loading the found program. If the specified program is 
not found, the FIND command terminates when an end-of-file (EOF). 
or end-of-medium (EOM) is encountered. The following messages 
are logged to the console device: 


EOF 
(program-label) NOT FOUND 


Exagple: 


FIND 1 INITCRT Searches for program INITCRT. 
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| FILE | 


2-12 FF (FORWARD FILE) COMMAND 


The FF command forward spaces the lu one filemark and positions 
the lu past the filemark. If no filemark is found, an error 
message is issued. 


Formats 


FF lu 


Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


Example: 


FF 2 forwards one file on lu 2. 


Error Messages: 


I/O DEVICE ERROR No filemark was found. 


. 
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! FORWARD {| 
{ RECORD | 


2.13 FR (FORWARD RECORD) COMMAND 


The FR command forward spaces the lu to the next record in the 
file. 


Formats: 
FR lu 


Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


Exasple: 


FR 2 Forwards one record on lu 2. 
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2-14 GO COMMAND 


The GO command starts execution of the load module by 
transferring control from the library loader to the transfer 
address of the loaded programs. 


Formats: 


GO 


Errcr Messages: 


CMD-ERR The transfer address of the loaded file was 
not specified. 
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2-1& LABEL COMMAND 


The LABEL command is used to label a program in a library file. 
Formats: 

LABEL lu[program-label| 
Parameters: 


lu is a decimal number fron 1 through 254 
specifying the lu to which a device is 
assigned. 


program-label is a1- to 8-character alphanumeric string 


indicating the name to be given to the program 
being labeled on the specified lu. 


Functional Details: 


Thig command causes the loader to output one record containing 
the specified program-label to the specified lu. If the 
program-label exceeds eight alphanumeric characters, only the 
first eight are used. This command can also be used prior to an 
assembly or compilation that writes the binary object program to 
the specified lu. 


If this command is used between an CU and XO command, it is 
rejected and the following error message is displayed: 
CMD-ERR 


Examples 


LA 1 CRTDVR Labels a frogram on lu 1 aS CRIDVR. 
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{| LABELED | 
| COMMON | 


2-16 LC (LABELED COMMON) COMMAND 


The LC command allocates the maximum amount of memory in bytes 
for a labeled common area. 


Formats: 


LC n 


Parameters: 


n is a  1- to 6-digit hexadecimal number 
specifying the number of bytes to allocate for 
labeled common. 


Functional Details: 


The LC command must be entered before the LO command is entered. 
When a labeled common area is specified by the LC command, the 
loader places the common area at the bias value or at the bias 
valve plus BC, if BC was previously specified. Labeled common 
can contain pre-loaded data before being loaded into memory. 


Exanples 


LC 2000 Allocates X‘'2000° bytes for labeled common. 
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2-17 LINK COMMAND 


The LINK command is used to load and link additional files after 
the LOAD command loads the first file. 


Formats: 
LINK lu[program-label ] 
Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


program-label isa I~ to 8-character alphanumeric string 
specifying the program on the specified lu to 
be linked and loaded into memory. 


Functional Details: 


The symbol table is not cleared, so the loaded program can be 
linked to any previously loaded program and can reference 
previously defined common blocks. The current bias values are 
used to load the program. If a program-label is specified, the 
user-specified lu is first searched for the program-label. If no 
program-label is specified, the first program encountered on the 
lu is loaded and Ilinked. Following a link operation, the 
specified lu is left-positioned past the end of the loaded 
programe 


Examples: 


LI 4 Loads and links a frogram from lu 4. 
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2-18 LF (LINKFILE) COMMAND 


The LF command links and loads all programs and subroutines in 
the specified file until an end-of-volume (EOV) is reached. 
Formats: 

LF 1lu[program-label] 


Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


program-label isa i- to 8-character alphanumeric string 
specifying the program on the specified liu to 
be linked and loaded into memory. 


Functional Details: 


Linking begins from the current position of the file. If a 
program~label is specified, the lu is positioned to that program 
befcre linking begins. 


Examples 


LF 4 Links and loads all programs from lu 4 until 
EOV is reached. 


48-020 ROO 4/80 2-19 


2-19 LOAD COMMAND 


THe LOAD command initializes the loader and loads a program from 
a specified lu at the current bias values. 


Format: 
LOAD lu[program-label | 
Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


program-label isa i- to 8-character alphanumeric string 
specifying the name of the program to be 
loaded. 


Functional Details: 


Befcre the program is loaded, the loader symbol table is cleared, 
and previously defined common blocks are released. This command 
should be used to load the first of a group of uSer programs not 
related to any previous job. If a program-label is specified, 
the specified lu is searched for the program-label. If no 
program-label is specified, the first program encountered on the 
lu is loaded. Following a load operation, the specified lu is 
left-positioned past the end of the loaded program. 


Examples 


LO 1 Loads a program from lu 1. 
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2-20 LG (LOG) COMMAND 
The LOG command logs all library loader commands from the 


command input device to a specified lu. 


Formats: 


Parameters: 


0 specifies logging is enabled. 
4 specifies logging is disabled. 
Lu is a hexadecimal number from 1 through 


specifying a log device. 


Exanple: 


LG 1,5 Disable logging to lu 5. 
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254 


2-21 MAP COMMAND 


The MAP command sends a memory map to the specified lu with all 
symbols in address order. The map shaws the location of programs 
loaded into memory and the locations of files output in a load 
module. The map includes only those files processed during and 
after the last load operation. 


Format: 


MAP lu 


Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which the map is sent. 


Functional Details: 


Link and edit operations add to the map, while the load operation 
begins a new onee The map shows the starting address of each 
file, the next available address, the location of every ENTRY 
defined, the starting address of each common block defined, and 
a list of any undefined EXTRNs. 


Examples: 
MA PRs 

PROGRAMS: 
NAME IMPURE PURE ABS NAME IMRURE PURE ABS 
EXIN.F12 016898 003010 000000 CLEANUP OOEEQE 000030 
DCB02200 0062C0 000400 INITTYKP 006348 000420 
DCB03800 006728 0005B0 DCB03900 006780 0005E8 

ENTRY-POINTS: 
000000 JRNLBKS 000000 ScTT 000000 SCTH 000060 SPT 0000D0 ISTAB 
000420 ISRiITYKP 000580 TYKPHMRK 000588 TYKPCR O0O059A TYKPBARW  000D72 ICRTHASH 


000D78 ICRTCR 000D86 ICRTBS 0023E8 ASYNCPB 002642 ARENDB 002648 AREOT 


COMMCN-BLOCKS: 


UNDEFINED: 
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2622 OUT COMMAND 


The OUT command selects the output mode used to generate a load 
module rather than to load rrograms into memory. 


Formats 
OU lu[{rrogram-label| 
Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


Pprogram-label isa 1- to 8-character alphanumeric string 
specifying the filename to be generated before 
the output mode is selected. 


Functional Details: 


In cutput mode, during load, link, and edit operations, all data 
normally loaded in memory is output in loader format to the 
specified lu. All programs are output as absolute code. The OU 
command sets the bias value to the first location above the 
current operating system. The BI command must be issued after 
the CU command if any other bias address is required. The pure 


bias address is reset to zero, Any external references or common 
references are resolved and converted to forward references 
without symbolic names. Thus, a load module program can be 


loaded by the 32-bit REL loader. 


Examples 


OU 2 Generates a load module on lu 2. 
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2-232 PAUSE COMMAND 


The PAUSE command causes the loader to pause. 


Formats: 


PAUSE 


Functional Details: 


The loader can be continued by the operator CONTINUE command, 
before the 
Do not use the PA command to assign additional disc files. 
the EN command to release memory and restart the 


the status of the loader will be the same as 


once all assignments are made. 


library 
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and 


pausee 


Use 


loader 
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| PURE BIAS | 


2-24 PB (PURE BIAS) COMMAND 


The PB command sets a bias address to be used as the base address 
for the pure relocatable segments. 
Formats: 

PB [adr] 


Parameters: 


adr is a %t- toa 6-digit hexadecimal number 
specifying the address to be used as the base 
address for pure segments. 


Functional Details: 


After loading a program, unless a new PB command is issued, the 
pure bias value is set to the next available location above the 
highest pure address used. When the loader is initially loaded, 
PB is Zero. This value is not initialized when the loader is 
restarted, but it is reset to zero by the BIAS and OU commends. 
The PER command cannot be used during output of an overlay module. 


Example: 


PB 1418 Sets the pure bias at X'1418°. 
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2-2& RW CREWIND) COMMAND 


The RW command rewinds the specified lu. 


Formats: 


RW lu 


Parameters: 


lu 


Examples 


RW 1 


is a decimal number from 1 through 
specifying the lu to which a device 
asSigned. 
Rewinds lu 1. 
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254 
is 
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2-26 TABLE COMMAND 


The TABLE command scans the first lt and lists on the second lu 
all program-labels found from the current file position when the 
command was issued until an EOF is read. 


Formats: 
TABLE lu,,lug 
Parameters: 


lu is a decimal number from 1 through 254 
specifying the lu to which a device is 
assigned. 


Functional Details: 


To list all program-labels on the first lu, ensure that the lu is 
positioned at the beginning of the file. If the record 
containing the program-label was passed before the TABLE command 
was entered, that program is not listed. Any program without a 
label in the file is not shcewn in the list. 


The TABLE command does not have the rewind capability. 
Examples 


TA 1,5 Lists program-labels from lu 1 to lu 5. 
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2227 TOP COMMAND 


The TOP command sets the highest memory address available to the 
loader for loading user programse The TOP command overrides the 
default that all memory on the system is available. 


Format: 
ToP[adr] 
Parameters: 


adr is a %1- to 6-digit hexadecimal number 
specifying the highest memory address 
available for user programs. 


Functional Details: 


The TO command can be used to build load medules for execution on 
systems with more or less memory than the system used to build 
the load module. This command deletes the symbol table. 


Example: 


TO FFFFF Sets the highest memory address available. 


NO 
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| WRITE- | 


| FILEMARK | 
2.28 WEF CWRITE-FILEMARK) COMMAND 
The WF command writes a filemark to the specified lu. 
Formats 
WF lu 
Parameters: 
lu is a decimal number from 1 through 254 
specifying the lu to which a device is 


assigned. 


Functional Details: 


If a device is write-protected and the WF command is attempted, 
an I/O error status will be issued. 


Examples 


WEF 2 Writes one filemark on lu 2. 


48-C20 ROO 4/80 2-29 


2e29 xXOUT COMMAND 
The XOUT command is used in conjunction with generation of a load 


module. XCUT generates the final record of the load module and 
then cancels the output mode. 


Format: 


XOUT 


Functional Details: 


This is a typical command sequence used to create a load modules: 


CUT 2 

BIAS AQOO 
LOAD 6 MAR 
LINK 7 
EDIT 8 
XQUT 
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APPENDIX A 
COMMAND SUMMARY 


AMAF lu 


BF la 

BIAS [adr | 

BR lu 

COPY lu,,lu, program-label 
DUPE lu,,lu, program-label 
EDIT lu[program-label| 

ENT 

FF lu 

FIND 1u [program-label| 

FR lu 

GO 

LABEL lu (program-label| 


LC n 
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LF lu[program-label | 


LINK lu[program-label | 
LOAL lu[pregram-label| 
MAP lu 


OUT lu (program-label | 


TABLE 1u,,1u, 
ToP[adr| 
WF lu 


XOUT 
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MEM- 


. APPENDIX B 
LIBRARY LOADER MESSAGE SUMMARY 


FULL 


A program being loaded exceeds the available memory space. 
If the program overlaps the takle, the MEM-FULL message is 
logged and the load is aborted. Not enough common space was 
allocated or the program loaded was too large. 


CMD-~ERR 


x * 


EOF 


EOM 


The loader does not recognize library loader commands if a 
LABEL (LA) command is found between an OUT (OU) command; if 
GO is issued when no transfer address was specified in any 
loaded program; or if an LI or ED command was entered before 
a program was loaded. 


NO PRCGRAMS * * BIAS (current location) 


A MAP was requested, and no programs were loaded. 


A filemark or ENDVOL was read during binary input. 


An end-of-media was encountered during a binary input. 


CKSM ERR - 


SEQ- 


A record was read in which the checksum did not match the 
checksum computed by the loader. Following the message, the 
loader paused. If the input device is paper tape, it can be 
Manually backspaced one record before continuing the load. 
Bulk storage devices are automatically backspaced when the 
CONTINUE command is entered. 


ERR 


A record was read out of sequence. Reposition the input lu 
at the beginning of the current program and retry. 
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REF-LOOP 


A loop was found in a forward or external reference thread, 
the object program was incorrectly generated, or the XO 
(XOUT) command was given during the building of overlay 
modules, when unresolved external references remain in the 
completed overlay. 


M Centry point) 


The specified entry pcint was defined more than once. The 
load continues, and the previous entry point encountered 
remains in effect. The others are ignored. 


LOAD ABORTED 


An unrecoverable error condition caused the abortion of a 
load in progress. Repeat the original LO command, which will 
clear any incorrect symbol locations that might have occurred 
in the symbol table. 


ADRS-ERR 


An attempt was made to load a program below the top of the 
loader. The program might contain absolute data at such an 
address or the impure bias might be set incorrectly. The 
load process is aborted. This error message is also 
Gisplayed if a program with references or definitions of 
halfword-address constants is loaded above 64K, or ifa 
subsequent declaration of a labeled common block is greater 
than the length of the first declaration of that common 
block. 


DEV END 


A device went off-line during input. 


I/O DEV ERR 
A parity error was detected on input, or an off-line 


condition was detected on output. The operating system 
status byte and a device address is displayed. 


LCALT ERR 


An illegal loader item was detected during a load. 
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(prcgram-label) NOT FOUND 


An end-of-device condition occurred before the program-label 
was located during a Search operation. 


If commands are issued in batch mode with logging suppressed, 
and an error is found, the last command executed is displayed 
on the console device. 


If the loading process is aborted in batch mode, the loader 
returns control to the operating system and issues an 
end-of-task code 1. If commands are issued interactively, 
the loader reads the next command from the console device. 
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APPENDIX C 
SAMPLE COMMAND SEQUENCE 


The following is an example of building an object load module 
while running in an OS/32 environment. It is assumed that CUP 
processing, which gives both the pure and impure bias values, was 
completed. 


LOAD .~BG, LIBLDR 

TASK .BG 

AS 1,Voin:CUPOUT.OBJ,SRC 
AS 2,S5YS.LIB,SRO 

AS 3,PR: 

AL Voln:SYSTEM.OBJ,IN 

AS 4,SYSTEM.OBJ 

AS 5,CONs 

START 

10:19:31 «BG LIBLDR 04-00 
-BG>OU 4 

eBG>TO FFFFF 

eBG>BI 189C 

~BG>PB 1418 

eBG>LO 1 

»BG>ED 1 

eBGOED 2 

e BG>XO0 

~BGOMA 3 

eBG>AM 3 

eBG>ENTL 

10:24:35 .~BG:END OF TASK 0 
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APPENDIX D 
SAMPLE LIBRARY CREATION 


LO.BG,LIBLDR 

AS1, PROG1.0BJ 
ALPROGLIB.OBJ,IN,126 
AS2, PROGLIB.OBJ 
AS3, CON: 

AS5, CON: 

AS4, PROG2.0BJ 

AS6, PROG4.OBJ 

AS7, PROGS.OBJ 
LIBLDR 04-00 


* &© £ + & + HF H 


- END 
- END OF TASK 


PROG3.OBJ is inserted between FROG2.0BJ and PROGH.OBJ in the file 
library: 


LO.BG,LIBLDR 
AS1, PROGLIB.OBJ 
ALNEWLIB.OBJ 
AS2, NEWLIB.OBJ 
CON: 

AS5, CON: 

AS4, PROG3.0BJ 


+ + + + + &€ & F 
= 
M 
WW 
. 


- LIBLDR 04-00 
- DUPE 1,2 PROGS 


- COPY 4,2 
- DUPE 1,2 
- RW 2 

- TABLE 2,5 
- RW 2 

- END 


- END OF TASK CODE 0 
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User-written subroutines can be edited from the library if the: 


subroutine contains a PROG statement, or a label is created 
with the LABEL command; 


subroutine contains an ENTRY statement with a name that is the 
same as the name in the label; 


user main file contains an EXTRN statement that refers to the 
name of the subroutine in the library. 
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INDEX 


AMAP, 2-2 GO command, 2-15 
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LIBRARY CREATION SAMPLE, [-1 
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AMAP, 2-2 LIBRARY LOADER OPERATION, 1-1 
EC, 2-6 LINK command, 2-18 
FIAS, 1-2, 2-5 LINKFILE command, 2-19 
EF, 2-3 LOCAL command, 2-20 
COPY, 2-7 LOG command, 2-21 
CUPE, 2-8 
EDIT, 2-9 MAP command, 2-22 
END, 2-11 
EFF, 2-13 OUT command, 2-23 
FIND, 2-12 
FR, 2-14 PAUSE command, 2-24 
GO, 2-15 PROGRAM LOADING, 1-2 
IABEL, 2-16 PURE BIAS command, 2-25 
LC, 2-17 Pure segments, 1-2 
LF, 2-19 
LG, 2-21 REWIND command, 2-26 
LINK, 2-18 
LOAD, 2-20 SAMELE COMMAND SEQUENCE, C-1 
MAP, 2-22 SAMFLE LIBRARY CREATION, CD-1 
FAUSE, 2-24 IMPURE, 1-2 
FB 1-2, 2-25 FURE, 1-2 
RW, 2-26 SEQUENCE, C-1 
SUMMARY, A-1 STATEMENT SYNTAX CONVENTIONS, 1-3 
TABLE 2-27 SUMMARY, LIBRARY LOADER MESSAGE, B-1 
TOP, 2-28 
WF, 2-29 TABLE command, 2-27 
XCUT, 2-30 THE OPERATING SYS LIBRARY LOADER, 1-1 
COMMAND SEQUENCE SAMPLE, C-1 TOP command, 2-28 
COMMAND SUMMARY, A-1 
COPY command, 2-7 WRITE-FILEMARK command, 27-29 
DUPE command, 2-8 XOUT command, 2-30 


EDIT command, 2-9 
END command, 2-11 


FINI command, 2-12 


FORWARD FILE command, 2-13 
FORWARD RECORD command, 2-14 
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